home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Utilities Experience
/
The Utilities Experience - Volume 1.iso
/
software
/
programmers
/
misc
/
agraconv
/
agraconv.doc
< prev
next >
Wrap
Text File
|
1978-06-29
|
6KB
|
142 lines
AGRACONV 1.0 AGRACONV 1.0
AGRACONV was written for the progammers and for those who need to convert
some graphics from IFF to the standard format for the Amiga hardware: the
RAW mode. I started to write this program because there are no very
friendly converter for the Amiga. The most powerful one was the KefrensIFF
converter, but it is very old and currently (with new Amiga's) it's no more
very reliable, can't manage any resolutions except 320x256 and of course it
doesn't support AGA display modes... AGRACONV tries to replace the old
KefrensIFF Converter, reproducing all the original features and adding many
exciting new options.
SYSTEM REQUIREMENTS
This Agraconv release requires AmigaOS 2.0 (v36) or higher to work
properly, but it fully supports the OS 3.0. Warning, no check is performed
by AGRACONV to ensure that the user loaded a picture "displayable" on the
in use Amiga (it could have a non AGA chipset!).
Some libraries are required:
- reqtools.library v37 (or higher)
- iff.library v22 (or higher)
- iffparse.library v37 (or higher)
HOW IT WORKS
Just after starting the program, a little info window will be displayed.
Clicking the 'OK' gadget the screen will become grey and Agraconv is ready
to be used. Bringing the pointer to the upper line of the screen and
pressing the right mouse button will display the menu strip (see above).
Pressing the left mouse button anywhere in the screen will activate the
picture framing. The framed picture will be saved using the Saving
options. Pressing the right mouse button anywhere else than the top of the
screen will open a little info window containing:
a) The current pointer coordinates (X and Y).
b) The width and the height of the current framed picture (W and H).
c) The memory size of a single plane of the framed picture and the memory
size of all the planes of the framed picture.
d) The number of the planes displayed (this is the number of the frames
that will be saved too).
It is possible to keep pressed simultaneously the right and the left mouse
buttons to frame the picture and showing the info window. However the info
window will vanish during the mouse movements and will be back again
leaving still the pointer for 1/20 of a second. Pressing the "+" key the
number of bitplanes shown will be increased, pressing the "-" key it will
be decreased.
THE MENU STRIP
There follows the step-by-step explanation of available menu strips. They
are specified as "Menu Title -> Item -> Sub-Item".
Project->Open (shortcut Amiga + O) - Shows a file requester you can use to
load a picture. If this is a standard IFF ILBM file, and it has no more
than 8 bitplane, it will be loaded immediately. If the file type is
unknown it has to be loaded as RAW image and you have to select the
video-mode.
Project->Save As->RAW (shortcut Amiga + R) - Shows a file requester you can
use to save your framed picture as RAW bitmap file.
Project->Save As->BLTRAW (shortcut Amiga + B) - Shows a file requester you
can use to save your framed picture as BLTRAW (interleaved bitmap) file.
Project->Save As->RAW MASK (shortcut Amiga + M) - Shows a file requester
you can use to save your framed picture as RAW MASK file (all bitplanes are
OR'ed together and the resulting outline is a single RAW bitplane).
Project->Save As->SPRITE 4 (shortcut Amiga + 4) - Shows a file requester
you can use to save your framed picture as 4 colour sprite(s) in
assembly-source mode. N sprite structures will be created, where N is
[framed image width]/16.
Project->Save As->SPRITE 16 (shortcut Amiga + S) - Shows a file requester
you can use to save your framed picture as 16 colour sprite(s) in
assembly-source mode. N sprite structures will be created, where N is
[framed image width]/16.
Project->Save As->IFF (shortcut Amiga + I) - Shows a file requester you can
use to save your framed picture as standard IFF-ILBM file (using the
byterun1 compression mode).
Project->Palette->Save As SOURCE (shortcut Amiga + C) - Saves the palette
in assembly-source format (Copper codes). Remember: you have to set the
"AGA Palette" item to save a full 24 bit palette.
Project->Palette->Save As RAW - Saves the palette as simply RGB values.
Project->Palette->Save As IFF - Saves the palette as standard ILBM CMAP (EA
Deluxe Paint compatible).
Project->Palette->Load IFF - Load a standard ILBM CMAP palette (EA Deluxe
Paint compatible).
Project->About - Shows some informations.
Project->Quit (shortcut Amiga + Q) - Quits AGRACONV.
Prefs->Grid - Turn on the grid on every sixteenth pixel of the frame box.
Prefs->AGA Palette - Turn on the 24 bit palette support.
Prefs->WB Requesters (shortcut Amiga + W) - Redirects all requester to the
Workbench screen. If the AGRACONV screen is smaller than 200x200 this flag
will be automatically set.
NOTE: Any other menu item have to be ignored from user.
MANY THANKS TO...
Wouter von Oortmerssen for the Amiga E compiler v2.1b.
Marco Lizza for the betatest and the AmigaGuide(tm) docs.
Francesco Simula for the betatest and the betatips.
Suggestions and bug reports are welcomed. Write to:
FIDONET: Fabrizio Farenga 2:335/332.31
E-MAIL: f.farenga@agora.stm.it
Holodream Software
Fabrizio Farenga
Via C. De Fabritiis, 55
I-00136
Roma, ITALY
END_OF_FILE
$VER: AGRACONV.DOC v1.0 (17.12.94) by Fabrizio Farenga